Skip to content

Walkthrough #1709

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Walkthrough #1709

wants to merge 6 commits into from

Conversation

rbenegal
Copy link
Contributor

@rbenegal rbenegal commented Jul 10, 2025

Description

Add some GIFs and additional steps for running, debugging and DocC previewing to the walkthrough created by @plemarquand.

Issue: #1560

Tasks

  • Required tests have been written
  • Documentation has been updated
  • Added an entry to CHANGELOG.md if applicable

plemarquand and others added 5 commits July 10, 2025 08:47
Adds a walkthrough to the package.json that guides users through:

- Installing Swift
- Creating a New Project
- Extension Commands
- Running Tests
- Selecting a Toolchain
Add some GIFs and additional steps for running, debugging and DocC
previewing.

Issue: swiftlang#1560
@rbenegal rbenegal marked this pull request as draft July 10, 2025 12:51
@rbenegal rbenegal marked this pull request as ready for review July 17, 2025 14:30
Copy link
Contributor

@award999 award999 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some suggestions, I now realize that the buttons are provided in the package.json, not the markdown files so I see you have a lot of the buttons I was suggesting :)

Thanks for doing this, looking great


![Open existing project](./images/openProject.gif)

When you open an existing project with a ``Package.swift`` file the extension will start automatically.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if open could be its own walkthrough where you could show the explorer with Package.swift in it and the swift package resolve task getting kicked off. Sort of visual image to know it's working.

If we split that to a separate walkthrough, could mention the prompt to open in new window OR add to workspace as a way to link to the multi-root workspace documentation for vscode.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah I originally had it as a separate step, but we didn't want to put too many steps in the walkthrough to intimidate the users so just put it briefly here in this step. Could add a longer GIF maybe showing a package resolve for a larger project, smaller projects load too quickly to see what's happening.

- Add additional pictures to clarify certain instructions
- Update the GIFs for testing view and DocC preview
- Ensure that each step has a unique completion action
to ensure that the checkbox is only checked after that step is viewed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants